# 硬件规格与快速上手

```{admonition} 本文引用的文件
:class: note

- [docs/docs/zh_CN/board/hardware.rst](../../../products/mpython/board/hardware.rst)
- [docs/docs/zh_CN/board/drive.rst](../../../products/mpython/board/drive.rst)
- [docs/docs/zh_CN/board/flashburn.rst](../../../products/mpython/board/flashburn.rst)
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/1_hardware/1_3_IO.rst](../../../products/mpython-s3/1_hardware/1_3_IO.rst)
- `esp32s3/firmware/boards/deploy.md`
- `esp32s3/firmware/boards/deploy_flashmode.md`
- `esp32s3/firmware/boards/deploy_nativeusb.md`
```

## 产品概述
mPython掌控板是基于ESP32/ESP32-S3的MicroPython微控制器开发板，面向K12创客教育场景，提供丰富的板载传感器、显示与音频能力，以及便捷的编程环境与示例代码。它支持图形化编程（如Labplus 3、Mind+）和Python/MicroPython脚本开发，适合教学、项目实践与原型验证。

- 目标用户：中小学创客教师与学生、电子爱好者、初学者开发者
- 核心价值：开箱即用、API友好、生态完善（IDE/示例/扩展库）、开源开放
- 适用场景：传感器数据采集、交互展示、物联网通信、语音与AI入门、机器人控制等

**章节来源**
- [docs/docs/zh_CN/board/hardware.rst:1-44](../../../products/mpython/board/hardware.rst)

## 核心业务流程
本节聚焦“从拿到板子到运行第一个程序”的关键流程：安装驱动、选择并烧录固件、进入REPL进行交互开发。

```text
flowchart TD
Start["开始"] --> InstallDriver["安装USB转串口驱动<br/>CP210x/CH9102/原生USB"]
InstallDriver --> ChooseFW{"选择目标板型"}
ChooseFW --> |ESP32 掌控板| FlashOld["使用乐鑫下载工具或esptool<br/>烧录ESP32固件"]
ChooseFW --> |ESP32-S3 掌控板3.0/乐动版| FlashS3["使用esptool.py<br/>擦除并写入固件"]
FlashOld --> EnterMode["进入下载模式<br/>部分版本需按键组合"]
FlashS3 --> EnterMode
EnterMode --> Verify["连接成功/识别端口"]
Verify --> REPL["打开REPL或IDE进行编程"]
REPL --> End["完成"]
```

**图示来源**
- [docs/docs/zh_CN/board/flashburn.rst:5-33](../../../products/mpython/board/flashburn.rst)
- `esp32s3/firmware/boards/deploy.md:5-52`
- `esp32s3/firmware/boards/deploy_flashmode.md:1-10`
- `esp32s3/firmware/boards/deploy_nativeusb.md:5-52`

**章节来源**
- [docs/docs/zh_CN/board/drive.rst:1-14](../../../products/mpython/board/drive.rst)
- [docs/docs/zh_CN/board/flashburn.rst:1-33](../../../products/mpython/board/flashburn.rst)
- `esp32s3/firmware/boards/deploy.md:1-55`
- `esp32s3/firmware/boards/deploy_flashmode.md:1-10`
- `esp32s3/firmware/boards/deploy_nativeusb.md:1-52`

## 功能模块清单
围绕“硬件参数—接口—驱动—固件”的入门需求，本指南覆盖以下关键模块：

- 硬件规格
  - ESP32 掌控板：主控ESP32、8MB Flash、Wi-Fi/BLE、OLED、六轴/磁力计、光线/声音、RGB灯、实体与触摸按键、I2C/SPI/UART等
  - ESP32-S3 掌控板3.0/乐动版：ESP32-S3双核、16MB Flash + 8MB PSRAM、1.47寸LCD、ES8388音频、QMI8658C六轴、MMC5603磁、LTR-308光线、双麦克风、RGB灯、实体/触摸按键、WiFi+BLE5
- 引脚与接口
  - 金手指IO：数字I/O、ADC、PWM、TouchPad、I2C、SPI、UART等
  - 专用接口：LCD屏引脚、音频解码芯片引脚
- 驱动安装
  - USB转串口驱动：CP210x（Windows/Mac），或原生USB（ESP32-S3）
- 固件烧录
  - ESP32：乐鑫下载工具或esptool，注意起始地址与字库烧录
  - ESP32-S3：esptool.py擦除后写入，支持原生USB或下载模式

**章节来源**
- [docs/docs/zh_CN/board/hardware.rst:10-53](../../../products/mpython/board/hardware.rst)
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:4-61](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/1_hardware/1_3_IO.rst:1-55](../../../products/mpython-s3/1_hardware/1_3_IO.rst)
- [docs/docs/zh_CN/board/drive.rst:1-14](../../../products/mpython/board/drive.rst)
- [docs/docs/zh_CN/board/flashburn.rst:1-33](../../../products/mpython/board/flashburn.rst)
- `esp32s3/firmware/boards/deploy.md:1-55`
- `esp32s3/firmware/boards/deploy_nativeusb.md:1-52`

## 数据与状态
- 供电与功耗
  - 工作电压：3.3V；最大工作电流与负载电流依板型而定
  - 供电方式：USB 5V或外部3.3V输入
- 存储与内存
  - ESP32：Flash容量与SRAM大小
  - ESP32-S3：Flash与PSRAM容量更大，支持更复杂应用
- 通信状态
  - Wi-Fi/BLE：用于网络与蓝牙设备通信
  - I2C/SPI/UART：用于外设与传感器通信
- 固件状态
  - 首次烧录建议先擦除Flash，再写入固件
  - 不同板型的固件起始地址与配置不同，需按文档操作

**章节来源**
- [docs/docs/zh_CN/board/hardware.rst:27-53](../../../products/mpython/board/hardware.rst)
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:54-61](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- `esp32s3/firmware/boards/deploy.md:5-33`

## 关键约束与边界
- 驱动兼容性
  - Windows/Mac需安装对应版本的CP210x驱动；ESP32-S3可使用原生USB
- 烧录注意事项
  - 首次烧录建议执行擦除；波特率与起始地址需匹配板型
  - 部分旧版本需手动进入下载模式（按住BOOT再复位）
- 引脚复用与限制
  - P4/P10等引脚被板载传感器占用，不可作为通用IO
  - I2C总线共享内部传感器，外接设备需注意冲突
- 电源与负载
  - 注意最大工作电流与负载电流，避免过载
- 软件生态
  - 推荐使用官方IDE或社区工具；示例代码位于仓库examples目录

**章节来源**
- [docs/docs/zh_CN/board/drive.rst:1-14](../../../products/mpython/board/drive.rst)
- [docs/docs/zh_CN/board/flashburn.rst:10-33](../../../products/mpython/board/flashburn.rst)
- [esp32s3/docs/1_hardware/1_3_IO.rst:1-55](../../../products/mpython-s3/1_hardware/1_3_IO.rst)
- `esp32s3/firmware/boards/deploy_flashmode.md:1-10`
- `esp32s3/firmware/boards/deploy.md:27-52`
- `esp32s3/firmware/boards/deploy_nativeusb.md:27-52`